FORFLO: Help & Documentation.

	FORFLO is started by the command R FORFLO.

	FORFLO performs many functions on FORTRAN source files:

	1.	Relabel FORTRAN  source  ststements.  Statements  are
given  new  numbers in ascending sequence. As a part of this process,
FORMAT statements may  be  moved  to  the  end  of  the  program  and
relabeled.

	2.	Create a flowchart of the source program

	3.	Optionally, reformat the source file into  80  column
card images, suitable for batch oriented compilers.

---------------------------------------------------------------------

	FORFLO commands have the following form:

	revision,listing←source

	Each of the terms in a command takes the form of:

	DEV:NAME.EXT,
	
	where DEV is a device name, NAME and EXT are  the  file  name
and extension of the file to be written on the device.

	The "revision" term denotes the output file where the revised
source will be written.  If no extension is given then ".FOR" will be
used.

	The  "listing"  term  denotes  the destination of the listing
file.  This can be LPT: or it may be a disk file.  If no extension is
given ".LST" is assumed.

	The "source" term names the file that is to be  processed.  A
project-programmer  number,  enclosed in square brackets is permitted
in the source term.  If no extension is given with  the  source  file
name  and  if the file named (with blank extension) can not be found,
then the extension ".F4" is tried.

	If the DEVice term is omitted anywhere,  the  device  DSK  is
assumed.

	If "NAME." appears, this forces a blank extension.

	If the "revision" term is omitted then no revised source file
will be created.  The command

	,listing←source

will produce only a listing file.

	If  the  listing  term is omitted, then no flowchart or cross
reference can be made.  The revised  file  only  is  created  by  the
command:

	revision←source.

	If both the listing and revision terms are omitted, then  the
input  file  will be checked for those errors that FORFLO can detect.
Error messages will be sent to the user  console.  Note  the  command
←source  without  switches is illegal because (see below) the absence
of switches in the command implies  flowcharting,  but  no  flowchart
occurs without a listing device.

	Switches are used to change  the  default  operation  of  the
program.   All  switches  are  in  the form of "/nnnL" where nnn is a
(possibly empty, empty = 0) string of  digits  and  L  stands  for  a
particular switch letter.

	If no switches are seen in the  command  then  the  following
defaults are specified:

	Cross Reference, Flowchart, relabeling (increment = 10)
	Format shuffle (first Format number = 10010)

	If any switch is seen  then  the  program  will  be  set  for
relabeling  (by  10) only.  Switches are then used to specify further
actions to be performed by the program. Switches may appear  anywhere
in  the  command  string  as  long  as  they  do  not  break any name
specification.

	The available switches are:


	/nnnS
	Use  nnn  as the increment in sequence numbering. The default
increment is zero. If the increment is zero then DEC formst  will  be
used  in  the  revision  file.   If the increment is non-zero then 80
column card image output will be prepared.  Sequenceing  is  done  in
columns  73-80.  Columns 73-76 contain a four letter subroutine name;
Columns 77-80 contain a four digit number that  counts  multiples  of
the sequencing increment


	/nnnL
	Use nnn as the increment in renumbering the statement labels.
/L OR /0L implies no renumbering of statements. The default increment
is 10.

	/A
	Make a Flowchart (implies /C). A listing device is required.

	/H
	Type  the  Help Listing (This listing).  The Help file should
be on SYS:FORFLO.HLP.

	/T
	No Tab conversion.  Tabs that occur in the source  file  will
not  be  converted to spaces.  /0S is implied by /T. If conversion to
card images is requested, then tabs will be changed to blanks.


	/B
	This switch causes blank lines in the source to be deleted.

	/K
	Keypunch conversion.  The following substitutions are made:

	( FOR %
	) FOR <
	= FOR #
	' FOR @
	+ FOR &

	This is provided to aid the conversion of  decks  punched  on
026 keypunches to 029 character codes.

	/nnnF
	Format  Shuffle:   All  the  FORMAT statements in the program
will be moved to the end of the program.  The argument, nnn, is  used
to  specify  the  number  with  which  the  first  format  should  be
relabeled.

	/C
	Make a Cross Reference table. A listing device is required.

	/Q
	QUIET.	Suppress all of the listing except for the flowchart.

	/X
	Flowchart only. This is the same  as  /L/A/S/T/Q.  No  source
modification is done; the listing includes only the Flowchart.

	/Y
	Do everything.	The effect is:
		1. Move FORMATs to the end of the program.
		2. Resequence the statement numbers
		3. Flowchart the revised program.
		   (No sequencing is done. Tabs are preserved.)

---------------------------------------------------------------------

	Command abbreviation.  The command:

	source

	is an abbreviation of the command

	name,name←source

	where "name" is the name of the source file found in "source".




	The command:

		NAME!

	will  cause  the core image file named NAME to be loaded from
device  SYS  and  started.  See  the  Time-Sharing  Monitor   manual,
DEC-T9-MTZA-D, Addendum 1, section 6.3 for details.

$